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SUMMARY OF SYSTEM CALLS 


Nucleus System Calls As They Apply To Object Types: 


Jobs Tasks Segments Mailboxes Semaphores Regions Extensions Composites 


Catalog$object Lookup$object 
UncatalogSobject GetStype 


CreateS- Create$- Create$- Create$- Create$- Create$- Create$- CreateS- 
job task segment mailbox semaphore region extension composite 


Deletes- Deletes- DeleteS- DeleteS- Deletes- Delete$- Deletes- Deletes- 
job task segment mailbox semaphore region extension composite 
Offspring SuspendStask Get$size Sends- Receive$- Receive$- Inspect$- 
message units control composite 


Get$pool$- | ResumeStask ReceiveS- Send$- Sends- AlterS- 
attributes message units control composite 


SetSpool$- Sleep AcceptS- 


minimum control 


GetStask$- 
tokens 


SetSpriority 
Get$priority 


Jobs Tasks Segments Mailboxes Semaphores Regions Extensions Composites 


> ae 7 ae <= 


Asynchronous I/O System Calls 


As They Apply To File Types: Bilcanype 


Named Named 
System Call Stream Physical Data Directory 


Attach$file 
Change$access 
Close 
Create$directory 
CreateSfile 


Delete$connection 
DeleteSfile 
Get$connection$status 
Get$directory$entry 
Get$extension$data 


GetS$fileSstatus 
Get$path$component 
Open 
Read 
Rename$Sfile 


Seek 
Set$extension$data 
Special 


Truncate 
Write 


SYSTEM CALLS 


The following abbreviations are used to indicate the data types of 
parameters in the system calls shown later: 


Abbreviation Meaning 

B Byte 
} Ww Word not containing a token 

WT Word containing a token 

OW Double word 

PW Pointer to a word not containing a token 
PWT Pointer to a word containing a token 

PS Pointer to a string 

PD Pointer to a data structure 

PI Pointer to an instruction 

Pp Any other kind of pointer 


A blue asterisk (*) following the semicolon indicates that a system call 
is for system programmers only 1 


NUCLEUS CALLS 


CALL RQSACCEPTSCONTRUL (region, except$ptr):- 
WT PW 


ESOK, ESBUSY, ESEXIST, ESNOTSCONFIGURED, ESTYPE 


CALL RQSALTERSCOMPOSITE (extension, composite, 
WT WT 


componentSindex, replacingSobj, except$ptr);- 
Ww WT PW 


ESOK, ESCONTEXT, ESEXIST, ESLIMIT, ESNOTSCONFIGURED, 
ESPARAM, ESTYPE 


ee 
CALL RQSCATALOGSOBJECT (job, object, name, except$ptr), 
WT WT PS PW 


ESOK, ESCONTEXT, ESEXIST, ESNOTSCONFIGURED, ESPARAM, 
ESTYPE 
ay 
composite = RQSCREATESCOMPOSITE (extension, tokenSlist$ptr, 
Wr WT PD 


except$ptr),* 
PW 


tokenSlist: 
STRUCTURE(num$slots WORD, 
numSused WORD, 
tokens(*) WORD); 


ESOK, ESEXIST, ESLIMIT, ESMEM, ESNOTSCONFIGURED, 
ESPARAM, ESTYPE 
PS 
extension = RQSCREATESEXTENSION (typeScode, 
WT WwW 


deletionSmailbox, exceptS$ptr);+ 
WT PW 


ESOK, ESCONTEXT, ESEXIST, ESLIMIT, ESMEM, 
ESNOTSCONFIGURED, ESPARAM, ESTYPE 


job = RQSCREATESJOB (directory$size, Param$obj, pool$min, 
WT WwW WT Ww 


pool$max, maxSobjects, maxStasks, max$priority, excpt$hndir, 
Ww WwW Ww B PD 


Ac 2 


ee ge ge 


job$flags, task$priority, startSaddress, dataSseg, stackSptr, 
Ww 8B PI WT [2 


stack$size, task$flags, exceptSptr); 
WwW Ww PW 


Excpt$hndirSinfo: 
STRUCTURE(EXCEPTIONSHANDLERSOFFSET WORD, 
EXCEPTIONSHANDLERSBASE WORD, 
EXCEPTIONSMODE BYTE) 
ExceptionS$Mode Control! to Exception Handler 
0 Never 
1 On programmer error only 
2 On environmental condition only 


On all exceptional conditions 


JobSflags Meaning 
(0) No parameter validation for new job 
2 Parameter validation for new job 


ESOK, ESCONTEXT, ESEXIST. ESLIMIT, ESMEM, ESPARAM 


mailbox = RQSCREATESMAILBOX (mailboxSfiags, except$ptr); 


WT Ww PW 
mailboxSflags Queueing Scheme 
0 First-in-first-out 
1 Priority Based 


ESOK, ESLIMIT, ESMEM, ESNOTSCONFIGURED 


SS 


region = RQSCREATESREGION (regionSflags, except$ptr);" 


WT WwW PW 
RegionSflags Queueing Scheme 

0 First-in-first-out 

1 Priority based 


ESOK, ESLIMIT, ESMEM, ESNOTSCONFIGURED 


Ee 


| segment = ROQSCREATESSEGMENT (size, exceptSptr), 
WT WwW PW 


ESOK, ESLIMIT, ESMEM, ESNOTSCONFIGURED 


aR © 


“ semaphore = RQSCREATESSEMAPHORE (initial$value, 


WT W 
maxSvalue, sem$flags, except$ptr); 
Ww WwW PW 
semSflags Queueing Scheme 
0 First-in-first-out 
1 Priority Based 


ESOK, ESLIMIT, ESMEM, ESPARAM, ESNOTSCONFIGURED 


task = RQSCREATESTASK (priority, startSaddress, data$seg, 
WT B Pl WwW 


stack$ptr, stack$size, taskSflags, except$ptr); 
P W Ww PW 


ESOK, ESLIMIT, ESMEM, ESNOTSCONFIGURED, ESPARAM 


— 
CALL RQSDELETESCOMPOSITE (extension, composite, 
WT WT 


exceptSptr); * 
PW 


ESOK, ESCONTEXT, ESEXIST, ESMEM, ESNOTSCONFIGURED, 
ESTYPE 
——————————  eeeeSSSSSSSFSSSSFsese 
CALL RQ$DELETESEXTENSION (extension, except$ptr); * 
WT PW 


ESOK, ESEXIST, ESMEM, ESNOTSCONFIGURED, ESTYPE 


ee ee ee 
CALL RQ$DELETESJOB (job, except$ptr); 
WT PW 


ESOK, ESCONTEXT, ESEXIST, ESMEM, ESNOTSCONFIGURED, 
ESTYPE 


EE 


CALL RQSDELETES$MAILBOX (mailbox, except$ptr); 
WT PW 


ESOK, ESEXIST, ESNOTSCONFIGURED, ESTYPE 


CALL RQ$DELETESREGION (region, except$ptr); * 
WT PW 


ESOK, ESCONTEXT, ESEXIST, ESNOTSCONFIGURED, ESTYPE 
4 
CR 


SSS 


CALL RQSDELETE$SEGMENT (segment, except$ptr); 
WT PW 


ESOK, ESEXIST, ESNOTSCONFIGURED, ESTYPE 


CALL RQ$DELETESSEMAPHORE (semaphore, except$ptr); 
WT PW 


ESOK, ESEXIST, ESNOTSCONFIGURED, ESTYPE 
a 
CALL RQSDELETESTASK (task, exceptSptr): 

WT PW 


ESOK, ESCONTEXT, ESEXIST, ESNOTSCONFIGURED, ESTYPE 


CALL RQ$DISABLE (level, exceptSptr); 


w PW 
level. Bits Value 
15-7 0 
6-4 the interrupt level (0-7) 
3 1 
2-0 0 


Note that actual level n equals encoded level n8H 


ESOK, ESCONTEXT, ESNOTSCONFIGURED, ESPARAM 


CALL ROQ$DISABLESDELETION (object. except$ptr);” 
WT PW 


ESOK, ESEXIST, ESLIMIT, ESNOTSCONFIGURED 


CALL RQ$ENABLE (level, exceptSptr); 


Ww PW 
level. Bits Value 
15-7 0 
6-4 the interrupt level (0-7) 
3 1 
2-0 0 


Note that actual level n equals encoded level n8H. 


ESOK, ESCONTEXT, ESNOTSCONFIGURED, ESPARAM 


Ey 5 


CALL RQSENABLESDELETION (object, exceptSptr); * 
WT PW 


ESOK, ESCONTEXT, ESEXIST, ESNOTSCONFIGURED 


CALL RQSENTERSINTERRUPT (level, exceptS$ptr): 


WwW PW 
level: Bits Value 
15-7 0 
6-4 The interrupt level (0-7) 
3 1 
2-0 0 


Note that actual level n equals encoded level n8H. 


ESOK, ESCONTEXT, ESNOTSCONFIGURED, ESPARAM 


CALL RQSEXITSINTERRUIPT (level, exceptSptr), 


Ww PW 
level Bits Value 
15-7 0 
6-4 the interrupt level (0-7) 
3 1 
2-0 0 


Note that actual level n equals encoded level n8H 


ESOK, ESPARAM 


CALL RQSFORCESDELETE (extension, object, except$ptr),* 
WT WT PW 


ESOK, ESEXIST, ESMEM, ESNOTSCONFIGURED, ESTYPE 


CALL RQSGETSEXCEPTIONSHANDLER (exceptionSinfoSptr, 
PD 


exceptSptr); 
PW 


ExceptionSinfo: 
STRUCTURE(EXCEPTIONSHANDLERSOFFSET WORD, 
EXCEPTIONSHANDLERSBASE WORD, 
EXCEPTIONSMODE BYTE); 


EN 


a 


ExceptlonSMode Control to Exception Handler 
0 Never 
1 On programmer error only 
2 On environmental condition only 
3 On all exceptional conditions 


ESOK, ESNOTSCONFIGURED 


| level = ROSGETSLEVEL (exceptSptr); 
Ww PW 
level: Bits Value/Interpretation 
15-8 undefined 


Q some level is being serviced 
and bits 6-4 are significant 


7 1 no level is being serviced 
and bits 6-4 are not 
significant 


6-4 an interrupt level (0-7) 
3-0 undefined 


ESOK, ESNOT$CONFIGURED 


CALL ROSGETSPOOLSATTARIB (attribSptr, except$ptr); 


PD PW 
Attrib: 
STRUCTURE(POOLSMAX WORD, 
POOLSMIN WORD, 


INITIALSSIZE WORD, 
ALLOCATED WORD, 
' AVAILABLE WORD), 


ESOK, ESNOTSCONFIGURED 


EEE 


priority = RQSGETSPRIORITY (task, except$ptr); 
8B WT PW 


ESOK, ESEXIST, ESNOTSCONFIGURED, ESTYPE 


size = RQSGETSSIZE (segment, except$ptr), 
Ww WT PW 


ESOK, ESEXIST, ESNOTSCONFIGURED, ESTYPE 


token = RQSGETSTASKSTOKENS (selection, except$ptr); 
WT B PW 


selection token 
0 calling task 
1 calling task’s job 
2 parameter object of calling task’s job 
3 root job 
ESOK, ESPARAM 


— 


type$code = RQSGETSTYPE (object, exceptSptr); 
WwW WT PW 


ESOK, ESEXIST, ESNOTSCONFIGURED 


CALL RQSINSPECTSCOMPOSITE (extension, composite, 
WT WT 


tokenSlist$ptr, exceptSptr);" 
PD PW 


tokenSlist: 

STRUCTURE(num$slots WORD, 
numSused WORD, 
tokens(*) WORD), 


ESOK, ESCONTEXT, ESEXIST, ESNOTSCONFIGURED, ESTYPE 


object = RQSLOOKUPSOBJECT (job, name, timeSlimit, 
WT WT PS WwW 


except$ptr); 
PW 


ESOK, ESCONTEXT, ESEXIST, ESLIMIT, ESNOTSCONFIGURED, 
ESPARAM, ESTIME, ESTYPE 


tokenSlist = RQSOFFSPRING (job, except$ptr): 
WT Saw PW 


ESOK, ESEXIST, ESLIMIT, ESMEM, ESNOTSCONFIGURED, ESTYPE 


CALL RQ$RECEIVESCONTROL (region, except$ptr); 
WT PW 


GE a 


ESOK, ESEXIST, ESNOTSCONFIGURED, ESTYPE 


a EEEEEEEEe 


object = RQSRECEIVESMESSAGE (mailbox, timeSlimit, 
WT WT Ww 


response$ptr, except$ptr); 
PWT PW 


ESOK, ESEXIST, ESNOTSCONFIGURED, ESTIME, ESTYPE 


Se 


value = ROSRECEIVESUNITS (semaphore, units, timeSlimit, 
Ww WT Ww Ww 


except$ptr), 
PW 


ESOK, ESEXIST, ESLIMIT, ESNOTSCONFIGURED, ESTIME, ESTYPE 


ee 


CALL RQSRESETSINTERRUPT (level, exceptSptr), 


WwW PW 
level: Bits Value 
15-7 0 
6-4 the interrupt level (0-7) 
3 1 
2-0 0 


Note that actual level n equals encoded level n8H. 


ESOK, ESCONTEXT, ESNOTSCONFIGURED, ESPARAM 


—_—_— 


CALL ROSRESUMESTASK (task, except$ptr); 
WT PW 


ESOK, ESCONTEXT, ESEXIST, ESSTATE, ESTYPE 


——— 


CALL RQSSENDSCONTROL (exceptS$ptr);* 
PW 


ESOK, ESCONTEXT, ESNOTSCONFIGURED 


EEE EEN 


CALL RQSSEND$MESSAGE (mailbox, object, response, 
WT WT WT 


except$ptr); 
PW 


ESOK, ESEXIST, ESMEM, ESNOT$CONFIGURED, ESTYPE 


SE 


CALL RQSSENDSUNITS (semaphore, units, except$ptr); 
WT Ww PW 


ESOK, ESEXIST, ESLIMIT, ESNOTSCONFIGURED, ESTYPE 
a 
CALL RQSSETSEXCEPTIONSHANDLER (exceptionSinfo$ptr, 
PD 
exceptSptr); 
PW 


Exception Sinfo: 
STRUCTURE(EXCEPTIONSHANDLERSOFFSET WORD, 


EXCEPTIONSHANDLERSBASE WORD, 
EXCEPTIONSMODE BYTE); 
ExceptionSMode Control to Exception Handler 
0 Never 
1 On programmer error only 
2 On environmental condition only 
3 On all exceptional conditions 


ESOK. ESNOTSCONFIGURED, ESPARAM 


CALL RQS$SETSINTERRUPT (level, interruptStaskSflag, 


WwW B 
interruptShandler, interruptShandlerS$ds, except$ptr), 
PI WT PW 
level: Bits Value 
15-7 0 
6-4 the interrupt level (0-7) 
3 1 
2-0 0 


Note that actual level n equals encoded level n8H 


ESOK, ESCONTEXT, ESNOT$CONFIGURED, ESPARAM 


CALL RQSSETSOSSEXTENSION (os$extension, start$address, 
B PI 


except$ptr),* 
PW 


ESOK, ESCONTEXT, ESNOTSCONFIGURED, ESPARAM 


SE 


CALL ROQ$SETSPOOLSMINIMUM (newS$min, except$ptr); 
Ww PW 


ESOK, ESLIMIT, ESNOTSCONFIGURED 


CALL RQOSSETSPRIORITY (task, priority, except$ptr);* 
WT B PW 


ESOK, ESCONTEXT, ESEXIST, ESLIMIT, ESNOTSCONFIGURED 
ESTYPE . 


CALL RQS$SIGNALSEXCEPTION (exceptionScode, param$num, 
Ww B 


stack$ptr, reserved, reserved, exceptSptr):* 
W Ww WwW PW 8 


ESOK, ESNOTSCONFIGURED 


CALL ROSSIGNALSINTERRUPT (level, except$ptr); 


WwW PW 
level: Bits Value 
15-7 0 
6-4 the interrupt level (0-7) 
3 1 
2-0 0 


Note that actual level n equals encoded level n8H 


ESOK, ESCONTEXT, ESNOTSCONFIGURED, ESPARAM 


CALL RQSSLEEP (timeSlimit, exceptSptr); 
Ww PW 


ESOK, ESNOTSCONFIGURED, ESPARAM 


CALL RQSSUSPENDSTASK (task, exceptSptr); 
WT PW 


ESOK, ESCONTEXT, ESEXIST, ESLIMIT, ESTYPE 


CALL RQSUNCATALOGSOBJECT (job, name, exceptSptr); 
WT PS PW 


ESOK, ESCONTEXT, ESEXIST, ESNOTSCONFIGURED, ESPARAM, 
ESTYPE 
UN 11 


CALL RQSWAITSINTERRUPT (level, except$ptr), 


WwW PW 
level: Bits Value 
15-7 0 
6-4 the interrupt level (0-7) 
3 1 
2-0 0 


Note that actual level n equals encoded level n8H. 


ESOK, ESCONTEXT, ESNOTSCONFIGURED, ESPARAM 


1/0 System Calls 


CALL RQSASATTACHSFILE (user, prefix, subpath, resp$mbox, 
WT WT PS WT 


except$ptr); 
PW 


Applies to all types of files. Priority of calling task must be in the range 
32 to 255. 


ESOK, ESBADSCALL, ESCONTEXT, ESEXIST, ESFNEXIST, ESFTYPE, 
ESIO, ESLIMIT, ESMEM, ESNOPREFIX, ESNOTSCONFIGURED, 


ESNOUSER, ESPARAM, ESTYPE 
ee 


CALL RQSASCHANGESACCESS (user, prefix, subpath, id, access, 
WT WT PS Ww B 


resp$mbox, except$ptr); 


WT PW 
Access: Bit Data File Access Directory File Access 
0 Delete Delete 
1 Read Display 
2 Append Add Entry 
3 Update Change Entry 
4-7 Reserved Reserved 


Applies only to named data and directory files. Calling task.specifying 
a non-null path must have a priority in the range 32 to 255 and must 
either be the owner of the file or have change-entry access to the file's 
parent aia 


W 12 


ESOK, ESBADSCALL, ESCONTEXT, ESEXIST, ESFACCESS, 
ESFLUSHING, ESFNEXIST, ESFTYPE, ESIFDR, ESIO, ESLIMIT, 
ESMEM, ESNOPREFIX, ESNOTSCONFIGURED, ESNOUSER, 
ESTYPE 


CALL RQSASCLOSE (connection, resp$mbox. exceptSptr); 
WT WT PW 


Applies to all types of files 


ESOK, ESBADSCALL, ESCONTEXT, ESEXIST, ESFLUSHING, 
ESLIMIT, ESMEM, ESNOTSCONFIGURED, ESTYPE 


CALL ROQSASCREATESDIRECTORY (user. prefix, subpath, access, 


WT WT PS B 
respSmbox, except$ptr); 
WT PW 
Access: Bit Kind of Access 
0 Delete 
1 Display 
2 Add Entry 
3 Change Entry 
4-7 Reserved 


Applies to named directory files only. Calling task must have a priority 
in the range 32 to 255 and must have add-entry access to the parent of 
the new directory 


ESOK, ESBADSCALL, ESEXIST, ESFACCESS, ES$FEXIST, 
ESFNEXIST, ESFTYPE, ESIFDR, ESIO, ESLIMIT, ESMEM 
ESNOPREFIX, ESNOTSCONFIGURED, ESNOUSER, ESPARAM 
ESSPACE, ESTYPE 


CALL ROQSASCREATESFILE (user, prefix, subpath, access, 
WT WT PS B 


granularity, high$size, lowSsize, must$create, resp$mbox, 
W Ww Ww B WwW 


exceptSptr); 
PW 


Access Bit Kind of Access 


0 Delete 
1 Read 
2 Append 
3 Update 
4-7 Reserved 
Granularity Value Meaning 
0 Same as volume granularity 


OFFFFH The file must be contiguous 


other Number of bytes allocation 


Applies to all types of files except named directory files Priority of 
calling task must be in the range 32 to 255 and for named files. calling 
task must have add-entry access to the new files parent directory 


ESOK ESBADSCALL. ESCONTEXT, ESEXIST ESFACCESS 
ESFEXIST. ESFNEXIST. ESFTYPE. ESIO, ESLIMIT, ESMEM. 
ESNOPREFIX. ESNOTSCONFIGURED, ESNOUSER. ESSPACE 
ESTYPE 


— 
CALL RQSASDELETESCONNECTION (connection resp$mbox 
WT WT 


exceptSptr} 
PW 


Applies to all types of files 


ESOK, ESBADSCALL ESCONTEXT. ESEXIST ESIO. ESLIMIT 
ESMEM ESNOTSCONFIGURED ESTYPE 


ea 
CALL ROSASDELETESFILE (user Prefix subpath respSmbox 
WT WT PS WT 


exceptSptr) 
PW 


Applies to stream and named files only Calling task using non-null 
path must have priority 32 or higher 


ESOK ESBADSCALL ESCONTEXT ESEXIST ESFACCESS 
ESFNEXIST ESFTYPE ESIFDR ESIO ESLIMIT. ESMEM 
ESNOPREFIX ESNOTSCONFIGURED ESNOUSER. ESPARAM 
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CALL ROSASGETSCONNECTIONSSTATUS (connection 


Ww 
respSmbox. exceptSptr) 
w Pw 
Result (to respSmbox) 
STRUCTURE (STATUS WORD 
FILESDRIVER BYTE 
FLAGS BYTE 
OPENSMODE BYTE 
SHARE BYTE 
LOWSFILESPTR WORD 
HIGHSFILESPTR WORD 
! ACCESS BYTE) 
FileSdriver Kind of Files Supported 
1 Physical files 
2 Stream files 
4 Named files 
OpenSmode Connection Mode 
10) Connection is closed 


1 Open for reading 
Open for writing 


Open for reading and writing 


Share Extent of Sharing 
0 Private use only 


1 Share with readers only 


2 Share with wrters only 
, 3 Share with all users 
Access Bit Data File Access Directory File Access 

0 Delete Delete 

1 Read Display 

2 Append Add Entry 

3 Update Change Entry 
4-7 Reserved Reserved 


Applies to all ‘ypes of files 


ESOK ESBADSCALL ESEXIST ESFLUSHING ESLIMIT ESMEM 


ESNOTSCONFIGURED ESTYPE ' aA 15 
T 


CALL ROSASGETSDIRECTORYSENTRY (connection. entrySnum 


WT Ww 
respSmbox. exceptSptr): 
WT PW 
Result (to respS$mbox) 
STRUCTURE (STATUS WORD. 
NAME(14) BYTE) 


Applies to named directory files only 


ESOK, ESBADSCALL. ESDIRSEND. ESEMPTYSENTRY. ESEXIST. 
ESFACCESS. ESFLUSHING. ESFTYPE. ESIFOR. ESIO. ESLIMIT. 
ESMEM. ESNOTSCONFIGURED. ESTYPE 


CALL RQSASGETSEXTENSIONSDATA (connection. respSmbox. 
WT WT 
exceptSptr):" 
PW 


Result (to respSmbox) 

STRUCTURE (STATUS WORD. 
COUNT BYTE 
INFO(*) BYTE). 


ESOK. ESEXIST. ESIFDR ESIO, ESLIMIT. ESMEM. 

ESNOTSCONFIGURED. ESTYPE 
ey 
CALL ROSASGETSFILESSTATUS (connection, respSmbox, 


WT WT 
exceptSptr): 
PW 

Result (to resp$mbox): 

STRUCTURE (STATUS WORD 
NUMSCONN WORD 
NUMSREADER WORD. 
NUMSWRITER WORD. 
SHARE BYTE. 
NAMEDSFILE BYTE. 
DEVSNAME(14) BYTE. 
FILESDRIVERS WORD. 
FUNCTS WORD. 
DEVSGRAN WORD, 


LOWSDEVSSIZE WORD, 
HIGHSDEVSSIZE WORD. 


mal i DEVSCONN WORD); 
Wee? & 16 


Share Extent of Sharing 
0 Private use only 
1 Share with readers only 
Share with writers only 


Share with all users 


FileSdrivers Bit Driver No. Driver 

0 1 Physical file 
2 Stream file 
3 Reserved 
4 Named file 


Functs Bit Function 
0 FSREAD 
1 FSWRITE 
2 FSSEEK 
3 FSSPECIAL 
4 FSATTACHSDEV 
3) FSDETACHSDEV 
6 FSOPEN 
uf FSCLOSE 
8-15 Reserved 


Extra result (follows other structure) 


STRUCTURE (FDESCSNUM WORD 
FILESTYPE BYTE 
FILESGRAN BYTE 
OWNER WORD 
LOWSCREATESTIME WORD. 
HIGHSCREATESTIME WORD 
LOWSACCESSSTIME WORD, 
HIGHSACCESSSTIME WORD 
LOWSMODSTIME WORD 
HIGHSMODSTIME WORD 
LOWSFILESSIZE WORD 
HIGHSFILESSIZE WORD. 
LOWSFILESBLOCKS WORD 
HIGHSFILESBLOCKS WORD 
VOLSNAME(16) BYTE. 
VOLSGRAN WORD 

ee 


LOWSVOLSSIZE 


HIGHSVOLSSIZE WORD. 
IDSCOUNT WORD, 
FIRSTSACCESS BYTE. 
FIRSTSID WORD 
SECONDSACCESS BYTE. 
SECONDSID WORD. 
THIRDSACCESS BYTE 
THIRDSID WORD): 


Applies to all types of files. 


ESOK. ESBADSCALL. ESEXIST. ESFLUSHING. ESLIMIT. ESMEM. 
ESNOTSCONFIGURED. ESTYPE 


CALL RQSASGETSPATHSCOMPONENT (connection, resp$mbox, 
WT WT 


exceptSptr) 
PW 


Result (to respSmbox) 
STRUCTURE (STATUS WORD, 
NAME(14) BYTE) 


Applies to all types of files 


ESOK, ESBADSCALL. ESEXIST, ESFLUSHING, ESIO, ESLIMIT. 
ESMEM, ESNOTSCONFIGURED. ESTYPE 


CALL ROSASOPEN (connection. mode, share. resp$mbox 
WT B 8 WT 


exceptSptr) 
Pw 


Mode Connection Mode 
Open for reading 
Open for writing 


Open for both reading and writing 


Extent of Sharing 
Private use only 
Share with readers only 
Share with writers only 


Share with all users 
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Directory files may only be opened for reading and for sharing with all 
users. 
ESOK. ESBADSCALL. ESCONTEXT, ESEXIST, ESFLUSHING. 
ESLIMIT. ESMEM. ESNOTSCONFIGURED. ESPARAM. 
ESSHARE, ESTYPE 


CALL RQSASPHYSICALSATTACHSDEVICE (devSname. fileSdriver 


PS B 
respSmbox. exceptSptr).* 
WT PW 
FileSdriver' Value File Driver 
1 Physical 
2 Stream 
4 Named 


ESOK. ESCONTEXT, ESDEVFD. ESEXIST. ESFNEXIST, ESILLVOL, 
ESIO. ESLIMIT, ESMEM, ESPARAM, ESTYPE 


CALL RQSASPHYSICALSDETACHSDEVICE (connection, hard. 
WT B 


respSmbox, exceptSptr) * 
WT PW 


ESOK. ESCONTEXT. ESEXIST. ESIO, ESLIMIT, ESMEM, 
ESNOTSCONFIGURED. ESTYPE 


CALL ROQSASREAD (connection, buffSptr. count, respSmbox, 
WT Pp Ww WT 


exceptSptr), 
Pw 


Applies to all types of files 


ESOK, ESBADSCALL. ESCONTEXT. ESEXIST. ESFLUSHING. ESIO. 
ESLIMIT, ESMEM. ESNOTSCONFIGURED., ESTYPE 


CALL RQSASRENAMESFILE (connection: user. prefix. subpath. 
WT WT WT PS 


respSmbox. exceptSptr), 
WT Pw 


Applies only to named data and directory files Calling task must have 
delete access to the file and add-entry access to the file's new parent 
directory 

19 


Rely 


ESOK, ESBADSCALL. ESCONTEXT, ESEXIST, ESFACCESS, 
ESFEXIST, ESFLUSHING, ESFNEXIST, ESFTYPE, ESIFDR, 
ESIO, ESLIMIT, ESMEM. ESNOPREFIX, ESNOTSCONFIGURED., 
ESNOUSER, ESPARAM, ESTYPE 


CALL RQSASSEEK (connection, mode, hi$ptrSmove, 


WT 8B Ww 
lowSptrSmove, respSmbox, exceptSptr): 
Ww WT PW 
Mode Action on Pointer 
1 Backward by ptrSmove 
2 Equal to ptrSmove 
3 Forward by ptrSmove 
4 


To end-of-file minus ptrSmove 
Applies only to physical files and named data files 


ESOK, ESBADSCALL. ESCONTEXT, ESEXIST, ESFLUSHING, 
ESIFDR, ESIO, ESLIMIT, ESMEM, ESNOTSCONFIGURED, 
ESPARAM, ESTYPE 


——<—$—$— — oseeeEeEeEeEeEeEeEeSESeSesesesesesesesesSsSses 


CALL RQSASSETSEXTENSIONSDATA (connection, data$ptr. 
WT PD 


respSmbox, except$ptr):* 
WT PW 


data 
STRUCTURE (COUNT BYTE. 
INFO(*) BYTE): 


Applies to asynchronous connections created via the named file driver. 


ESOK. ESEXIST. ESIO, ESLIMIT. ESMEM. ESNOTSCONFIGURED, 
ESPARAM. ESTYPE 


—————— 


CALL RQSASSPECIAL (connection. specSfunc. 1oparmSptr, 
WT Ww P 


respSmbox,. except$ptr): 
WT Pw 
c 20 
52 


SpecSfunc: 
File Driver SpecSfunc 
for Connection Value Function 
physical 0 format 204 or 206 track 
physical or named 2 notify 
stream 0 query 
stream 1 "satisfy 


ioSparam (for formatting 204 floppy track) 
STRUCTURE (TRACKSNUMBER WORD, 

INTERLEAVE WORD, 

TRACKSOFFSET WORD): 


ioSparam (for formatting 206 hard disk track): 
STRUCTURE (TRACKSNUMBER WORD, 


INTERLEAVE WORD, 
TRACKSOFFSET WORD 
FILLSCHAR WORD). 
ioSparam (for notify): 
STRUCTURE (MAILBOX WORD, 
OBJECT WORD): 


ESOK, ESBADSCALL, ESCONTEXT, ESEXIST, ESFLUSHING, 
ESIDDR, ESIFDR, ESIO. ESLIMIT, ESMEM. ESNOTSCONFIGUREI 
ESTYPE 


CALL RQSASTRUNCATE (connection, resp$mbox, exceptSptr); 
WT WT Pw 


Applies to named data files only 


| ESOK. ESBADSCALL, ESCONTEXT, ESEXIST, ESFACCESS, 
ESFLUSHING, ESIFDR, ESIO. ESLIMIT, ESMEM 
\ ESNOTSCONFIGURED. ESTYPE 


CALL ROSASWRITE (connection. buffSptr. count, respSmbox, 
WT Pp W WT 


exceptSptr) 
PW 


Applies to all types of files except named directory files The calling 


task must have append or update access to the file. x 


ESOK. ESBADSCALL. ESCONTEXT. ESEXIST. ESFACCESS 
ESFLUSHING, ESIO. ESLIMIT. ESMEM. ESNOTSCONFIGURED, 
ESSPACE, ESTYPE 


user > RQSCREATESUSER (idsSptr. exceptSptr). * 
WT PS PW 


ids 

STRUCTURE (LENGTH WORD, 
COUNT WORD. 
{D(*) WORD); 


ESOK, ESLIMIT, ESMEM, ESNOTSCONFIGURED ESPARAM 


CALL ROSDELETESUSER (user. except$ptr): ” 
WT PW 


ESOK. ESEXIST, ESNOTSCONFIGURED, ESTYPE 


connection = ROSGETSDEFAULTSPREFIX (job. exceptSptr) 
WT WT PW 


ESOK. ESBADSCALL, ESEXIST, ESNOPREFIX, ESNOTS- 
CONFIGURED. ESTYPE 


userSid = ROSGETSDEFAULTSUSER (job. exceptSptr) 
WT WT Pw 


ESOK. ESBADSCALL, ESEXIST. ESNOTSCONFIGURED, ESNOUSER, 
ESTYPE 


dateStime = ROSGETSTIME (exceptSptr): 

DW PW 
ESOK. ESBADSCALL. ESNOTSCONFIGURED 
ee 


CALL RQSINSPECTSUSER (user. idsSptr. exceptSptr);* 
WT PS PW 


ids: 

STRUCTURE (LENGTH WORD, 
COUNT WORD, 
ID(*) WORD): 


ESOK, ESEXIST, ESNOTSCONFIGURED, ESPARAM, ESTYPE 
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CALL RQOSSETSDEFAULTSPREFIX (job. prefix except$ptr); 
WT WT PW 


ESOK, ESBADSCALL, ESEXIST ESLIMIT. ESMEM, ESNOTS- 
CONFIGURED. ESTYPE 


oe 


CALL ROSSETSDEFAULTSUSER (job. user, exceptSptr): 
WT WT PW 


ESOK, ESBADSCALL, ESEXIST, ESLIMIT, ESMEM, ESNOTS- 
CONFIGURED. ESTYPE 


————  eeSeSeSeSSSSSSSSSSSSSSSSSsSSsmsmsmsMMsMsseseF 


CALL ROSSETSTIME (timeShigh. timeSlow. exceptSptr): * 
WwW WwW PW 


ESOK, ESNOTSCONFIGURED 


LOADER CALL 


CALL RQSASLOAD (connection, respSmbox. exceptSptr): 
WT WT PW 


Result (to respS$mbox) 

STRUCTURE (STATUS WORD, 
RECORDSCOUNT WORD 
ERRORSRECSTYPE BYTE. 
NUMSUNDEFSREFS WORD 


INITSIP WORD. 
INITSCS WORD. 
STACKSOFFSET WORD. 
INITSSS WORD 

STACKSSIZE WORD. 
INITSDS WORD), 


ESOK, ESABSSADDRESS. ESBADSGRP, ESBADSHDR, ESBAD$SEG, 
ESCHECKSUM, ESCONTEXT, ESEXIST, ESNOTSCONFIGURED, 
ESRECSFMT, ESRECSLENGTH. ESRECSTYPE, ESSEGSALLOC, 
ESTYPE 
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1/0 SYSTEM RESULT SEGMENT 


STRUCTURE (STATUS 
UNITSSTATUS 
ACTUAL 
ACTUALSFILL 
DEVICE 
UNIT 
FUNC 
SPECSFUNG 
LOWSDEVSLOC 
HIGHSDEVSLOC 
BUFFSPTR 
LOWSCOUNT 
HIGHSCOUNT 
AUXSPTR 
LINKSFOR 
LINKSBACK 
RESPSMBOX 
DONE 


WORD. 
WORD. 
WORD 
WORD. 
WORD. 
BYTE 
BYTE, 
WORD 
WORD. 
WORD 
POINTER, 
WORD, 
WORD, 
POINTER, 
POINTER, 
POINTER, 
WORD, 
BYTE): 


Values in low-order byte of UNITSSTATUS 
(valid only when STATUS = ESIO = 2BH): 


Value Mnemonic 
0 lOSUNCLASS 
1 |1OSSOFT 
2 |OSHARD 
3 IOSOPRINT 
4 lOSWRPROT 


Meaning 
Unclassified error 
Soft error; retry is possible 
Hard error: retry not possible 
Operator intervention required 
Write-protected volume 
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1/0 SYSTEM PATH/SUBPATH INFORMATION 


Prefix Subpath 
Parameter Parameter Designated Connection 


Either O or Connection whose token is 


pointer to the default prefix 
null string © 


Pointer to 
ASCIil string 


ASCII string defines a path 
from the connection whose 

token is the default prefix to 
the target connection 


Either 0 or 
pointer to 
null string 


Connection whose token is 
contained in the prefix 
Parameter 


Prefix parameter contains a | 
token for connection. ASCII 
string defines a path from that 
connection to the target 
connection 


Pointer to 
ASCII string 
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TERMINAL HANDLER 


SPECIAL CHARACTERS AND THEIR EFFECTS 


Special 
Character Effect 


RUBOUT Deletes previously entered character 
Line Feed Signals end of line 
ESCape Signals end of line 


Calls the RQSABORTSAP procedure 
control-D. Activates the Debugger 
Kills or restarts output 
Resumes suspended non-Debugger 
outpul 


Sends an empty message 


REQUEST MESSAGE FORMAT 


Offset Field 
Function 
Count 
Eyception Code 
Actual 


Message Content 
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INTERRUPT INFORMATION 


ALLOCATION OF INTERRUPT VECTORS 


0- 55° reserved 
56- 63 available for external interrupt levels 0-7 respectively 
64-223 reserved 


224-255' available for Operating System Extensions 
1-32 respectively 


INTERRUPT LEVELS DISABLED FOR RUNNING TASK 


Task Priority Disabled Levels 
[ 0-16 0-7 
17-32 1-7 
33-48 2-7 
49-64 3-7 
65-80 4-7 
81-96 Se7/ 
97-112 6-7 
113-128 7 
129-255 None | 


Interrupt Levels Vs. Interrupt Task Priorities 


Level Interrupt Task Priority 
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DEBUGGER SYNTAX 


EXPRESSION: 


ITEM: 


S = SENDERS ONLY 
R > RECEIVERS ONLY 
T= TASK ONLY 

J > ENTIRE JOB 

C = CONTINUE 

D = DELETE 
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S = SENDERS ONLY 
R = RECEIVERS ONLY 
T= TASK ONLY 

J= ENTIRE JOB 

C = CONTINUE 

D = DELETE 


DELETING A BREAKPOINT: 


(2) BREAKPOINT VARIABLE 


EXAMINING A BREAKPOINT: 


30 


VIEWING THE BREAKPOINT LIST: 


a) 


VIEWING THE BREAKPOINT PARAMETERS: 


—e)— 


REMOVING A TASK FROM THE BREAKPOINT LIST: 


ESTABLISHING THE BREAKPOINT TASK: 


OO 


INQUIRING AS TO THE BREAKPOINT TASK: 
—er)— 
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VIEWING THE BREAKPOINT TASK’S REGISTERS: 


32 


ALTERING THE BREAKPOINT TASK’S REGISTERS: 


@) 
©) 
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*AHOW3W ONIASIQOW YO ONININVXS 


INSPECTING SYSTEM OBJECTS: 


J JOB 
T TASK 

E EXCHANGE 
G SEGMENT 
c 

x 


COMPOSITE 
EXTENSION 


VIEWING SYSTEM LISTS: 


JOB(S) 

TASK(S) 

READY TASK(S) 
SUSPENDED TASK(S) 
EXCHANGE(S) 

TASK QUEUES AT 
EXCHANGE(S) 
OBJECT QUEUES AT 
MAILBOX(ES) 
SEGMENT(S) 
COMPOSITE(S) 
EXTENSION(S) 


xOO SF Emnvac 
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DEFINING A NUMERIC VARIABLE: 


CHANGING A NUMERIC VARIABLE: 


DELETING A NUMERIC VARIABLE: 


VIEWING NUMERIC VARIABLE(S): 


EXITING THE DEBUGGER: 


—(e)— 
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